home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir40 / popkey.zip / POPKEY.DOC < prev   
Text File  |  1993-08-02  |  9KB  |  174 lines
  1.                 ----------
  2.                 POPKEY.DOC
  3.                 ----------
  4.  
  5. POPKEY is a memory resident program that provides a variety of useful key-
  6. board utilities.  Version 1.0 makes one utility available.  The keyboard's
  7. typematic rate can be changed with this utility.
  8.  
  9. The typematic rate is defined as the number of make codes sent to the com-
  10. puter by the keyboard processor per second when a key is held down (a make
  11. code is a positive decimal integer starting at zero and less than 128 that
  12. uniquely identifies the key being pressed).  The computer's BIOS converts
  13. make codes into ASCII or extended ASCII codes.  Before auto-repeating, the
  14. keyboard processor waits for a brief interval of time.  This interval pre-
  15. vents keys from being repeated unintentionally.  BIOS stands for the Basic
  16. Input/Output System.
  17.  
  18. The typematic rate can range from 2 make codes per second (the slowest) to
  19. 30 make codes per second (the fastest).  The delay can range from 1/4 sec-
  20. ond (the shortest) to 1 second (the longest) in 1/4 second increments.
  21.  
  22. Not all keyboards are created equal.  Older keyboards with the 10 function
  23. keys along the left-side have a fixed typematic rate which cannot be modi-
  24. fied.  However, keyboards with the 12 function keys along the top can have
  25. this rate changed.
  26.  
  27. POPKEY was built with a TSR TOOLKIT which I designed.  This toolkit cannot
  28. function with any version of DOS less than 3.30.  Therefore, you must have
  29. DOS 3.30 or higher in order to use POPKEY.
  30.  
  31. The POPKEY package consists of POPKEY.DOC (documentation file) and POPKEY.
  32. COM (program file).
  33.  
  34. Installing POPKEY on your computer is easy.  Assuming that you want POPKEY
  35. located in a directory called POPKEY just below the root directory on your
  36. C: drive and that the POPKEY files are on a floppy disk in drive A:, these
  37. commands would be used to perform the install.
  38.  
  39. 1. C: [ENTER]
  40. 2. MD \POPKEY [ENTER]
  41. 3. CD \POPKEY [ENTER]
  42. 4. COPY A:*.* [ENTER]
  43.  
  44. The [ENTER] means to press the ENTER key.  In step 1, you are making sure
  45. that your hard drive (C:) is the current drive.  In step 2, you are making
  46. a directory just below the root directory to hold the POPKEY files.  In
  47. step 3, you make the POPKEY directory the current directory.  Finally, the
  48. fourth step copies the POPKEY files from the floppy disk in A: to this new
  49. directory.
  50.  
  51. POPKEY is installed in memory by typing POPKEY and pressing the ENTER key.
  52. The TSR (Terminate but Stay Resident) logic ensures that only one copy of
  53. POPKEY is loaded into memory.  POPKEY can be removed from memory if it is
  54. the most recently installed TSR by typing POPKEY /U and pressing ENTER (/U
  55. is the uninstall option).
  56.  
  57. The default hotkey is ALT-K.  This hotkey can be changed to any one of the
  58. combinations ALT-0 through ALT-9 or ALT-A through ALT-Z inclusive by using
  59. the /K option.
  60.  
  61. Ex: POPKEY /K5
  62.  
  63. This example sets the default hotkey to ALT-5.
  64.  
  65. The TSR logic contains a mechanism to ensure that DOS is in a stable state
  66. before a TSR can activate.  This might result in a delay of a few seconds
  67. after the hotkey is pressed and before the TSR activates.  It is possible
  68. to have the TSR beep when its hotkey is pressed to ensure that the hotkey
  69. was acknowledged.  The /B option provides this capability.  By default, no
  70. beeping takes place.  However, /B1 enables beeping (/B0 disables beeping).
  71.  
  72. Ex: POPKEY /KZ /B1
  73.  
  74. This example sets the default hotkey to ALT-Z and enables beeping.
  75.  
  76. When POPKEY activates, a dialog box appears.  This dialog box provides you
  77. with the capability to change the typematic rate along with the delay.
  78. There are two fields in this dialog box.  You can move between fields with
  79. the UP/DOWN arrow keys, the TAB/SHIFT TAB keys, or the ENTER key.  If the
  80. last field is current and you press ENTER, the dialog box vanishes and the
  81. typematic rate/delay value is set.  If POPKEY cannot change these values,
  82. then it beeps once to let you know.  If you press the ESC key, the dialog
  83. box vanishes and POPKEY beeps twice to let you know that it will not alter
  84. the typematic rate/delay.  You can press the spacebar or ALT-spacebar to
  85. cycle through the list of choices for the current field.  Press the F1 key
  86. for additional help.
  87.  
  88. POPKEY is the first of a line of productive TSRs which I call POPTOOLS.  I
  89. will be introducing new products including POPCOM (a popup communications
  90. program) and POPFMT (a popup floppy disk format program) to supplement the
  91. line.
  92.  
  93. POPKEY is a shareware program.  You may examine POPKEY to see if it meets
  94. your needs.  If it does then I would ask that you register your copy.  By
  95. registering, you are letting me know that you find this program useful and
  96. want to see more.  Registration involves sending some money to myself.  In
  97. return, I will mail you another TSR program which I call POPCC (POPUP Con-
  98. trol Center).
  99.  
  100. POPCC, when activated, displays a listbox of resident TSRs created with my
  101. TSR TOOLKIT.  The name of each TSR and its current hotkey setting are dis-
  102. played within this listbox.  You simply highlight the line containing the
  103. name of the TSR whose hotkey you wish to change and type either A-Z or 0-9
  104. to change the hotkey.  Simple.  As I introduce more POPTOOLS products, you
  105. will find POPCC to be even more valuable.  You can even change the hotkey
  106. for POPCC right from its listbox.
  107.  
  108. If you are a programmer and interested in creating TSRs, you might want to
  109. check out TSR TOOLKIT.  This toolkit allows you to write TSRs in C (using
  110. the Borland C/C++ compilers) and automatically generate an executable TSR.
  111. All of the hard work in creating a stable kernel has been performed.  Ver-
  112. sion 1.5 is the latest.  With this version, your TSRs have complete access
  113. to extended memory via the included XMS API.  Of course, you must have the
  114. HIMEM.SYS driver loaded via your CONFIG.SYS file.  Numerous example TSRs
  115. with complete source code are included along with a library of C functions
  116. which can be called from your application (video, keyboard, file, sprintf,
  117. mouse, etc) and alot of documentation.  Please request TSR TOOLKIT if you
  118. want it when registering.
  119.  
  120. The registration fee for POPKEY is $10.  Postage and handling is included.
  121. Please specify the size of disk that you want (5-1/4 1.2 meg, 3-1/2 720K,
  122. or 3-1/2 1.44 meg).  Your disk will contain POPCC.DOC, POPCC.COM, and TSR
  123. TOOLKIT v1.5 (if requested).  Please send cheque or money order to:
  124.  
  125. Geoff Friesen
  126. Box 94
  127. Dauphin, MB
  128. Canada R7N 2T9
  129.  
  130.          ----------------end-of-author's-documentation---------------
  131.  
  132.                          Software Library Information:
  133.  
  134.                     This disk copy provided as a service of
  135.  
  136.                            Public (software) Library
  137.  
  138.          We are not the authors of this program, nor are we associated
  139.          with the author in any way other than as a distributor of the
  140.          program in accordance with the author's terms of distribution.
  141.  
  142.          Please direct shareware payments and specific questions about
  143.          this program to the author of the program, whose name appears
  144.          elsewhere in  this documentation. If you have trouble getting
  145.          in touch with the author,  we will do whatever we can to help
  146.          you with your questions. All programs have been tested and do
  147.          run.  To report problems,  please use the form that is in the
  148.          file PROBLEM.DOC on many of our disks or in other written for-
  149.          mat with screen printouts, if possible.  PsL cannot debug pro-
  150.          programs over the telephone, though we can answer questions.
  151.  
  152.          Disks in the PsL are updated  monthly,  so if you did not get
  153.          this disk directly from the PsL, you should be aware that the
  154.          files in this set may no longer be the current versions. Also,
  155.          if you got this disk from another vendor and are having prob-
  156.          lems,  be aware that  some files may have become corrupted or
  157.          lost by that vendor. Get a current, working disk from PsL.
  158.  
  159.          For a copy of the latest monthly software library newsletter
  160.          and a list of the 4,000+ disks in the library, call or write
  161.  
  162.                            Public (software) Library
  163.                                P.O.Box 35705 - F
  164.                             Houston, TX 77235-5705
  165.  
  166.                                 1-800-2424-PSL
  167.                              MC/Visa/AmEx/Discover
  168.  
  169.                           Outside of U.S. or in Texas
  170.                           or for general information,
  171.                               Call 1-713-524-6394
  172.  
  173.  
  174.